GUIDED TOUR
Overview
This topic covers in brief the various control sections of the front panel editor in IOTBuilder. The front panel editor is accessible from the project tree when one or more IOT Controls are added to the current project.

1. Project Tree / File structure
2. Control Properties
3. Editing Window
4. Output Window
The Project Tree
The project tree sits on the left hand side of the editor. In the context of IOT Builder it serves four main purposes:
1) Switch between panel design and flowchart program.
2) Context menu command set for adding IOT controls to the front panel.
3) Drag and drop placement of controls on the front panel.
4) Configuration of controls from the property panel at the bottom.
The following short example illustrates these points.
Adding a button
The following procedure uses an Arduino Yun target but the process is the same regardless of target so you could also follow these steps with targets such as Raspberry Pi.
Start a new flowchart project and select Arduino Yun as the target device.

Right click on the Yun in the Project Tree and select 'Add IOT control' from the context menu.

Select a button from the resulting dialogue and then drag and drop it onto the front panel editor.

Left click to select the button and then edit it's properties from the property page at the bottom of the project tree.

The Editing Window
The drawing area for the front panel is determined by the target device (desktop browser, iPad, iPhone, Galaxy S6, etc.). To set or change the target device:
1) Right click on IOT Panel in the Project Tree and select Panel Settings from the resulting context menu.

The IOT Panel becomes available in the project tree as soon as you add an IOT control to your project. You can do this via the add IOT Control command on the Project Menu or through the right click context menu.
2) Select the form factor on the left of the dialogue form and then the size and resolution for the device on the right hand side. The values to be input here are the CSS width and height (CSS Device Independant Pixels).

You can find a fairly exhaustive list on this website: https://www.mydevice.io/#compare-devices
3) Close the dialogue form to resize your panel to the target device. Note that if you do this once IOT controls have been placed and you go from a large device to a small device there may not be enough space for all of the controls you have placed. It's best to choose your target device at the beginning.
The Graphics Panel
The graphics panel on the left hand side contains a selection mode and then a series of graphics and text primitives as described below:
![]()
After placing graphics, you can position or edit using the property page at the bottom of the Project Tree. First enter selection mode, left click on the graphic and then edit in the property panel.

The most common use for this toolbar is to create some graphics and text for grouping other controls together on your panel.
Note that this text mode is for entering static text on the panel If you want to input text commands on your device to send to your hardware then you need to add an IOTControl such as text input or terminal.
The Colour Palette
The colour palette sits at the bottom of the front panel editor and dictates the default stroke and fill colour of the next drawn graphic.
![]()
Stroke
The stroke is the 'pen' used to draw the graphic lines. It has a colour and a thickness. You can change the colour of the stroke by double clicking on the existing colour and you can change the thickness of the pen via the edit box at the side.

Fill
The fill specifies whether the object is wireframe (not coloured in) or in which colour it should be filled. You can change the fill by clicking on the desired colour from the palette to the right of the existing fill colour.

Note that changes made here will affect the default for future graphic objects. If you want to change the stroke/fill of an existing graphic you must first select it and then adjust via the property page at the bottom of the project tree.
Zoom and Navigation
You can zoom in or out of the panel via the icons at the top of the application.
![]()
Alternatively, you can use the F6 key to zoom in, the F7 key to zoom back out and the F8 key to return the zoom level to the default view.
Grids and Snap
You can configure and turn on grids to aid placement and also snap the mouse cursor to the current grid.
You can set up your grid by right clicking on the IOT Control Panel in Project Tree and selecting Panel Settings from the context menu.

The setting at the bottom right allows you to specify a grid spacing and defaults to 10.

If you set this higher you will have less grid squares on your panel which means less snap points. By contrast, if you set this lower you will have more freedom to position on the panel but it might be harder to align objects precisely. We'd suggest that you leave this at default value unless you know what you are doing.
Once configured you can turn grid and snap on or off via the icons at the top of the Panel Editor.
![]()